package com.sky.service;

import com.sky.dto.OrdersConfirmDTO;
import com.sky.dto.OrdersPageQueryDTO;
import com.sky.dto.OrdersSubmitDTO;
import com.sky.result.PageResult;
import com.sky.vo.OrderPaymentVO;
import com.sky.vo.OrderSubmitVO;
import com.sky.vo.OrderVO;

/**
 * 订单服务接口
 */
public interface OrderService {
    
    /**
     * 用户提交订单
     * @param ordersSubmitDTO 订单提交数据
     * @return 订单提交结果（包含订单ID、订单号、金额等信息）
     */
    OrderSubmitVO submitOrder(OrdersSubmitDTO ordersSubmitDTO);
    
    /**
     * 订单支付
     * @param orderId 订单ID
     * @return 支付必要的参数
     */
    OrderPaymentVO payment(Long orderId);
    
    /**
     * 支付成功，修改订单状态
     * @param outTradeNo 商户订单号
     */
    void paySuccess(String outTradeNo);
    
    /**
     * 用户端订单分页查询
     * @param ordersPageQueryDTO 查询条件
     * @return 分页结果
     */
    PageResult pageQueryUser(OrdersPageQueryDTO ordersPageQueryDTO);
    
    /**
     * 管理端订单分页查询
     * @param ordersPageQueryDTO 查询条件
     * @return 分页结果
     */
    PageResult pageQueryAdmin(OrdersPageQueryDTO ordersPageQueryDTO);
    
    /**
     * 查询订单详情
     * @param id 订单ID
     * @return 订单详情
     */
    OrderVO getOrderDetail(Long id);
    
    /**
     * 用户取消订单
     * @param id 订单ID
     */
    void userCancelById(Long id);
    
    /**
     * 商家取消订单
     * @param id 订单ID
     */
    void adminCancelById(Long id);
    
    /**
     * 接单
     * @param ordersConfirmDTO 确认接单数据
     */
    void confirmOrder(OrdersConfirmDTO ordersConfirmDTO);
    
    /**
     * 开始派送
     * @param id 订单ID
     */
    void startDelivery(Long id);
    
    /**
     * 完成派送
     * @param id 订单ID
     */
    void completeDelivery(Long id);
    
    /**
     * 获取订单统计数据
     * @return 订单统计信息
     */
    OrderStatisticsVO getStatistics();
    
    /**
     * 用户催单
     * @param id 订单ID
     */
    void remindOrder(Long id);
}